PATHMac OS 8 and 9 Developer Documentation > Networking and Communications > URL Access Manager >

Transferring Files With the URL Access Manager

Event Constants

URL event constants are passed to your notification callback routine Notification Callback Routine to receive the type of event that occurred. The URL event constants are defined in the URLEvent enumerator.

enum
{
    kURLInitiatedEvent              = kURLInitiatingState,
    kURLResourceFoundEvent          = kURLResourceFoundState,
    kURLDownloadingEvent            = kURLDownloadingState,
    kURLAbortInitiatedEvent         = kURLAbortingState,
    kURLCompletedEvent              = kURLCompletedState,
    kURLErrorOccurredEvent          = kURLErrorOccurredState,
    kURLDataAvailableEvent          = kURLDataAvailableState,
    kURLTransactionCompleteEvent    = kURLTransactionCompleteState,
    kURLUploadingEvent              = kURLUploadingState,
    kURLSystemEvent                 = 29,
    kURLPercentEvent                = 30,
    kURLPeriodicEvent               = 31,
    kURLPropertyChangedEvent        = 32,
    };
typedef UInt32 URLEvent;

Constant Descriptions

kURLInitiatedEvent
The function URLOpen has been called but the location specified by the URL reference has not yet been accessed.
kURLResourceFoundEvent
The location specified by the URL reference has been accessed and is valid.
kURLDownloadingEvent
A download operation is in progress.
kURLAbortInitiatedEvent
A download or upload operation has been aborted.
kURLCompletedEvent
All operations associated with calling URLOpen have been completed. This event indicates the successful completion of a download or upload operation or the completion of cleanup work after aborting a download or upload operation.
kURLErrorOccurredEvent
An error occurred.
kURLDataAvailableEvent
Data is available in buffers.
kURLTransactionCompleteEvent
A download operation is complete because there is no more data to retrieve from buffers.
kURLUploadingEvent
An upload operation is in progress.
kURLSystemEvent
A system event occurred.
kURLPercentEvent
An increment of one percent of the data was transferred into buffers. This event occurs only when the size of the data being downloaded is known.
kURLPeriodicEvent
A time interval of approximately one quarter of a second has passed.
kURLPropertyChangedEvent
A property, such as a filename or a user name, has become known or changed. For information about the properties that may cause this event to occur, see Property Name Constants .
© 1999 Apple Computer, Inc. – (Last Updated 07 May 99)